package com.quectel.core.module.partyeducationtraining.service;


import com.quectel.core.module.partyeducationtraining.dto.TrainingItemPersonDto;
import com.quectel.core.module.partyeducationtraining.dto.ref.TrainingItemRefConcourseItemDto;
import com.quectel.core.module.partyeducationtraining.dto.ref.TrainingItemRefPersonDto;

import java.math.BigDecimal;
import java.util.Date;
import java.util.List;
import java.util.Map;

/**
 * @author ryan
 * @email ryan.ran@quectel.com
 * @date 2022/05/07 16:40
 */
public interface TrainingItemPersonService {

    /**
     * 获取唯一关系记录
     *
     * @param trainingItemId 课时id
     * @param deptPersonId   学员id
     * @return
     */
    TrainingItemPersonDto selectOne(Long trainingItemId, Long deptPersonId);

    /**
     * 开始学习或刷新学习进度
     *
     * @param trainingId     培训id
     * @param trainingItemId 课时id
     * @param deptPersonId   人员id
     * @param dateTime       学习时间
     * @param studyProgress  学习进度 TrainingItemConstants.StudyProgressEnum
     */
    void study(Long trainingId, Long trainingItemId, Long deptPersonId, Date dateTime, BigDecimal studyProgress);

    /**
     * 根据学员获取已学习课时总数
     *
     * @param map
     * @return
     */
    int queryTrainingItemTotal(Map<String, Object> map);

    /**
     * 根据学员获取已学习课时信息
     *
     * @param map
     * @return
     */
    List<TrainingItemRefConcourseItemDto> queryTrainingItemList(Map<String, Object> map);

    /**
     * 根据课时获取学员与学习信息列表
     *
     * @return
     */
    List<TrainingItemRefPersonDto> queryPersonList(Map<String, Object> map);

    /**
     * 根据课时获取学员与学习信息总数
     *
     * @return
     */
    int queryPersonTotal(Map<String, Object> map);

    /**
     * 根据id查询一条记录 有缓存默认五分钟
     *
     * @param id
     * @return
     */
    TrainingItemPersonDto selectCacheById(Long id);

    /**
     * 根据id查询一条记录
     *
     * @param id
     * @return
     */
    TrainingItemPersonDto selectById(Long id);

    /**
     * 查询列表
     *
     * @param params
     * @return
     */
    List<TrainingItemPersonDto> queryList(Map<String, Object> params);

    /**
     * 查询数量
     *
     * @param params
     * @return
     */
    int queryTotal(Map<String, Object> params);

    /**
     * 存入一条记录
     *
     * @param dto
     * @return 存入数据的id
     */
    Long save(TrainingItemPersonDto dto);

    /**
     * 根据id更新一条记录 字段为null不更新
     *
     * @param dto
     */
    void updateById(TrainingItemPersonDto dto);

    /**
     * 根据id更新一条记录  字段为null会更新 建议先查询再更新
     *
     * @param dto
     */
    void updateAllColumnById(TrainingItemPersonDto dto);

    /**
     * 根据id删除一条记录
     *
     * @param id
     */
    void deleteById(Long id);

    /**
     * 批量删除
     *
     * @param ids
     */
    void deleteBatch(Long[] ids);
}
